home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Amiga News 95
/
Amiga News 95.iso
/
dpat
/
dpat13
/
documentation
/
dp managing.francais
< prev
next >
Wrap
Text File
|
1992-09-16
|
54KB
|
1,144 lines
Documentation de DP Managing
Copyright 1992 David Scrève
---------------------------
--------------------
Document :
Auteur : David Scrève
Nom : DP Managing.doc
Nom de l'application : DP Managing
Version : 2.21
Révision : 6.51
Date : 16 Septembre 1992
Taille : 53999 octets
Pour tout renseignement ou pour obtenir votre code utilisateur contactez moi
à l'adresse suivante :
M. Scrève David
DP Managing Support
4, rue Gustave Flaubert
59115 Leers
FRANCE
Tèl : 20.75.52.73 en Province.
Pour obtenir un code utilisateur,envoyez une demande écrite en me parlant
de vous et en décrivant ce que vous souhaitez faire avec DP Managing 2.21.
Sommaire linéaire :
-------------------
Titre Ligne
----- -----
Introduction..................................................0095
Matériel requis...............................................0149
Installation..................................................0172
Documentation Utilisateur.....................................0189
I - Concept général de DP Managing 2.21...................0192
II - Mise en route du programme...........................0215
III - Options des menus déroulants........................0298
A - Menu Projet.......................................0307
1 - Sauver le catalogue : Amiga + C...............0312
2 - Maintenance : Amiga + M.......................0329
3 - A Propos... : Amiga + A.......................0343
4 - Quitter : Amiga + Q...........................0353
B - Menu Programme....................................0366
1 - Rechercher : Amiga + J........................0373
C - Menu Exporter.....................................0386
1 - Nouveautés : Amiga + D........................0399
2 - Tout : Amiga + T..............................0406
3 - Correspondance Code-catégorie : Amiga + R.....0413
D - Menu Imprimer.....................................0422
1 - Nouveautés : Amiga + N........................0427
2 - Tout - Amiga + U..............................0438
3 - Statistiques : Amiga + I......................0451
4 - Correspondance code-catégorie : Amiga + G.....0461
5 - Quelques catégories : Amiga + K...............0469
E - Menu Modules......................................0479
1 - Consultation Simple : Amiga + O...............0482
2 - Emprunts : Amiga + E..........................0494
3 - Ajout de programmes : Amiga + P...............0502
4 - Statistiques : Amiga +S.......................0527
F - Menu Langues......................................0536
1 - Francais : Amiga + F..........................0543
2 - English : Amiga + H...........................0548
IV - Description des divers modules.......................0554
A - Maintenance.......................................0558
1 - DETRUIRE LA CATEGORIE.........................0573
2 - CREER UNE CATEGORIE...........................0582
3 - ELIMINER UN ADHERENT..........................0591
4 - AJOUTER UN ADHERENT...........................0603
5 - DETRUIRE LA NOTION DE NOUVEAUTE...............0614
6 - CHANGER DE CATEGORIE..........................0624
7 - DETRUIRE LE PROGRAMME.........................0633
8 - AJOUTER UN PROGRAMME..........................0643
9 - DETRUIRE UN DISQUE............................0662
10 - MODIFIER LE PROGRAMME........................0670
11 - CHARGER DES EMPRUNTS.........................0679
B - Consultation Simple...............................0689
C - Emprunts..........................................0714
D - Ajout de programmes...............................0791
E - Statistiques......................................0845
Conclusion....................................................0870
Historique des versions.......................................0885
Evolutions futures............................................1030
Rapport de Bug................................................1052
Remerciements et CopyRight....................................1104
----------------------------------------------------------------------------
Introduction
------------
DP Managing a été écrit dans le but d'intégrer dans un unique
environnement de travail toutes les tâches liées à la gestion d'une
bibliothèque de programmes du Domaine Public.
Le produit complet se compose d'une disquette comportant :
- Les sources du programmes compressés avec LHA
- 2 fichiers de documentation sur DP Managing : DP Managing.francais et
DP Managing.english
- Les dessins de l'interface sauvés sous forme de fichiers binaires pour
GadToolsBox 1.0 et compressés avec lha.
- Les 2 versions de DP Managing 2.21, compilées pour MC 68000 et pour cartes
accélératrices dotées d'un MC 68030 et MC 68882
- Les 2 librairies powerpacker.library et reqtools.library
- La commande CLI XICON Domaine public
- Le programme de compactage LHA Domaine Public
- 2 fichiers de remise à jour rapide pour les utilisateurs des anciennes
version de DP Managing 2.xx : 2.21 UpDate.francais pour les francais
et 2.21 UpDate.English pour les autres, dans le répertoire UpDate.
- 1 fichier de complément sur l'utilisation de l'interface utilisateur
du système 2.04 en francais ainsi que des requesters de la reqtools.library
utilisée dans DP Managing 2.21 : UserStyle.doc
- 2 Scripts d'installation du programme en anglais et francais.
DP Managing 2.21 est librement distribuable dans la mesure ou il n'est
pas distribué dans un but lucratif. Le programme ne peut être distribué
sous une autre forme que dans le package décrit ci-dessus, et aucun autre
fichier ne doit cohabiter sur la même disquette. Aucun des fichiers dont
je suis l'auteur faisant partie du package ne pourra être distribué
séparément à l'exception de UserStyle.doc dont la diffusion à grande
échelle et sous toute les formes à but non lucratif est encouragée.
Par but non lucratif, j'entend un prix de disquette n'excédant pas 15 FF.
De plus, DP Managing 2.21 ne pourra être mis en téléchargement sur des
serveurs plus chers que le 3613 et ne pourra faire partie de disquettes
distribuées dans des magazines. Enfin, DP Managing ne pourra être
distribuée que par des associations régies par la loi de 1901, et les
SARL sont privées de ce droit.
Il existe en outre un autre programme nommé DP Managing UGC (User Code
Generator) permettant de créer de nouveaux codes utilisateurs. Ce programme
n'est absolument pas distribué : Seul David Scrève est accrédité à le pos-
séder et à l'utiliser.
Les sources ne sont fournis que dans un but de documentation que les
techniciens sauront apprécier à sa juste mesure. Je veux dire par là que
toute recompilation du programme complet ou d'un morceau ne pourra se faire
que par mon accord écrit. L'utilisation de routines décrites dans ce source
ne sera aussi autorisée qu'avec mon accord écrit, en particulier lors d'une
réalisation à but commerciale. Le non respect de ces quelques règles de
respect de la création m'obligera à des actions judiciaires, à mon grand
regret. En espérant ne pas me tromper, je fais, pour cela, confiance à la
communauté créative Amiga.
Matériel requis
---------------
La conception hautement visuelle de DP Managing 2.21 impose certaines
contraintes matérielles que tout bon Amigaiste ferait bien d'acquérir s'il
souhaite rester dans le coup.
DP Managing 2.21 fonctionne sur tout Amiga munis d'un Système 2.04
complet, ou plus. Attention, le programme d'installation a besoin de
nombreuses commandes CLI : Veillez bien à ce que votre système n'a pas été
victime d'une de vos crises d'économies. N'oubliez pas que chaque fichier du
Workbench effacé réduit les performances de l'ensemble de votre système.
Des versions compilées pour 68030 et 68882 sont présentes sur la disquet-
-te et le programme d'installation sait les détecter. Toutefois, il faut
savoir que la version pour carte accélératrice ne pourra fonctionner sur
un système ne possédant pas au minimum un 68020 et un 68881.
DP Managing 2.21 fonctionne sur disquette, mais son installation nécessite
2 lecteurs ou un disque dur. Si vraiment vous ne pouvez vous procurer au
moins 2 lecteurs, contacter moi et je vous enverrais la procédure d'instal-
-lation avec 1 seul lecteur. L'utilisation d'un disque dur est fortement
conseillé en ces temps de forte baisse de prix, du fait des accès disques
incessant de DP Managing 2.21. Ceci pourrait être critiqué, mais actuellement
il est moins coûteux d'utiliser les mémoire de masse et aussi moins dange-
-reux.
Installation
------------
La procédure d'installation a été automatisée au maximum est conserve
le "Look And Feel" très graphique de l'application.
Pour Installer DP Managing 2.21 il suffit d'insérer la disquette
d'installation dans le lecteur DF0: après avoir chargé le WorkBench 2.04 ou
plus. Il suffit alors de cliquer 1 fois sur l'icône d'installation, puis 1
fois sur le répertoire où vous voulez faire l'installation et enfin de
cliquer 1 fois sur l'icône d'installation. Pour information, cette procédure
permet de passer des paramètres à une fonction comme si vous le faisiez sous
Shell.
Il est important de signaler que DP Managing 2.21 ne va pas s'installer
dans le répertoire que vous avez sélectionné, mais va y créer son propre
répertoire d'installation. Ce type de question s'est trop souvent posée pour
que je la passe sous silence.
Documentation Utilisateur
-------------------------
I - Concept général de DP Managing 2.21
-----------------------------------
Contrairement aux précédentes versions de DP Managing (et
principalement la 1.2 récemment encore utilisée par Ordileers),
DP Managing 2.21 se veut totalement graphique, exploitant le plus possible
les nouvelles ressources graphiques du système 2.0. Le but recherché dans
cela est avant tout le confort de l'utilisateur. Ainsi, lorsqu'il y a une
série de données à saisir au clavier, on se déplace dans chacune d'elles à
l'aide de la touche de tabulation, pour éviter ce va-et-vient constant entre
la souris et le clavier qui rend parfois les interfaces graphiques moins
pratiques que le mode texte des PC et compatibles.
La conception de DP Managing 2.21 est organisée autour du concept de
module. Actuellement, 4 modules sont disponibles et regroupent l'ensemble
des fonctions relatives à un secteur précis d'activités. Un cinquième module
particulier regroupe les outils nécessaires à la maintenance de la base de
données.En outre, certaines fonctions sont accessibles dans la plupart des
modules par menus déroulant. Elles concernent l'impression, la sauvegarde,
les changements de modules et la fin de cession.
Cette documentation va d'abord s'attacher à décrire les divers menus
déroulants puis nous verrons en détail chacun des modules disponibles.
II - Mise en route du programme
--------------------------
La mise en route de DP Managing 2.21 est fort simple : il suffit de
double cliquer sur son icône. Attention : DP Managing ne peut pas être lancé
à partir du Shell, il nécessite des informations dans le Tools Types de
l'icône. En voici une brève description :
NOUVEAUTES = nom du fichier contenant les nouveautés.
EMPRUNTS = nom du fichier contenant les emprunts de toutes la base de
données.
PROGRAMMES = nom du fichier contenant tous les programmes de la base
de données.
SPECIAL = nom du fichier contenant les programmes interdit aux mineurs
CATEGORIE = nom du répertoire contenant les différentes catégories de
programmes. Chaque catégorie représentant en fait un fichier
DISQUE = nom du répertoire contenant les différents disques. Chaque
disque représentant en fait un fichier.
ADHERENTS = nom du répertoire contenant les différents adhérents
Chaque adhérent représentant en fait un fichier.
TEMPDIR = nom du répertoire contenant les fichiers temporaires de copie
créés durant le traitement des commandes. En principe, lors-
qu'aucune erreur n'a eut lieu, ce répertoire est vidé après
utilisation.
FIRSTDISK = numéro du premier disque à créer lorsque qu'une nouvelle
base de données est créér.
LANGUAGE = Nom de la langue par défaut de DP Managing. Actuellement
ce doit être ENGLISH ou FRANCAIS
NOTE : Aucun de ces fichiers n'est directement accessible par un éditeur
de texte : ce sont des fichiers binaires dont la répartition des données
n'est pas uniforme. Aucune documentation ne sera fournis mis à par les
sources. Pour toute autre information, veuillez me contacter avec une
justification sérieuse pour avoir une description de mon format de fichier.
Enfin, pour les jeunes bricoleux qui souhaiteraient emprunter des programmes
qui ne sont pas de leur age, sachez que le calcule de l'age d'un adhérent
nécessite plus de 150 opérations sur 1 seul chiffre code sur 4 octets signés.
La sécurité des données est à ce prix.
Par défaut, les fichiers nommés ci-dessus sont créés à la première
utilisation s'il n'existent pas, et les répertoires sont créés à l'instal-
-lation. Un non démarrage de l'application est la plupart du temps dû à
une icône mal configurée. Voici un exemple de la configuration par défaut,
après installation :
NOUVEAUTES = fich_nouveautes
EMPRUNTS = fich_emprunts
PROGRAMMES = fich_programmes
SPECIAL = fich_special
CATEGORIES = categorie
DISQUES = disque
ADHERENTS = adherent
TEMPDIR = tempdir
FIRSTDISK = 201
LANGUAGE = FRANCAIS
ATTENTION :
---------
La destruction de l'un de ces éléments détruit l'intégrité de la base de
données et la rend inutilisable.
Enfin, si vous souhaitez remplacer l'icône fournie, remplacez-la par
une icône du type PROJECT (cf la doc de IconEd)
Lorsque vous avez alors double-cliqué sur l'icône, il vous faut alors
rentrer votre nom avec les bon accents tels qu'ils vous ont été communiqués
puis valider par [RETURN]. Vous devez alors taper votre numéro d'utilisateur
et valider par [RETURN]. Si vous tentez de rentrer des lettres, l'écran
clignotera et refusera l'entrée.
Une fois votre nom et votre code entré, vous avez droit à 2 entrées
dans les 2 gadgets pour corriger vos erreurs. Si vous vous trompez de trop,
vous serez tout de même dans DP Managing 2.21, mais dans la version d'évalua-
-tion avec l'ajout de programmes impossibles.
Si vous n'avez pas de code utilisateur, il vous suffit de fermer la
fenètre et vous entrerez dans la version d'évaluation de DP Managing 2.21.
DP Managing 2.21 vous souhaitera alors la bienvenue à sa manière en vous
indiquant la configuration de votre système. Cliquer alors dans le Gadget OK
pour commencer à travailler.
III - Options des menus déroulants
----------------------------
DP Managing 2.21 comporte seulements 4 menus déroulants, car j'ai
préféré privilégier l'utilisation des boutons et autres gadgets dès que
possible pour leur coté plus intuitif et plus efficace (c'est d'ailleurs
cela qui fait que le programme nécessite au moins le système 2.0). Chaque
fonction possède son raccourci clavier via la touche Amiga.
A - Menu Projet
-----------
Il regroupe les fonctions générales à toute la base de données
1 - Sauver le Catalogue : Amiga + C
-------------------------------
Cette option permet de sauver tout le catalogue sur
disquette, classé par catégorie de programmes. La configuration nécessitée
par chaque programme n'est pas écrite et ne le sera jamais afin que le
catalogue puisse tenir dans 80 colonnes et être ainsi visualisé par des
programmes du type MuchMore.
Lorsque vous sélectionnez cette option, un FileRequester
standard va apparaitre pour vous permettre de choisir votre fichier de
sauvegarde. Si vous sélectionnez un fichier déjà existant, une confirmation
vous sera demandée pour écraser ce fichier. Pour l'utilisation du
FileRequester, consultez la documentation du système 2.0 ou le livre Amiga
User Interface Style Guide chez Addison Wesley.
2 - Maintenance : Amiga + M
-----------------------
Cette option vous permet d'accéder aux fonctions de
maintenance de la base de données. Avant toute utilisation, il est conseillé
de faire une sauvegarde de votre base de données.
Lorsque vous sélectionnez cette option, la fenètre change
et vous pouvez voir de nouveaux Gadgets à l'écran. Toutefois, toutes les
fonctions des menus déroulants restent accessibles. Nous étudieront ce
module de maintenance en détail dans le paragraphe suivant concernant les
divers modules.
3 - A Propos... : Amiga + A
-----------------------
Cette option vous permet d'obtenir des informations sur
DP Managing 2.21 et sur ses auteurs. Cette option ne vous sera utile que si
vous faites partie des développeurs de cette application ou lorsque vous
souhaiterez faire une remise à jour de votre programme qui, de toute façon
sera remis à jour régulièrement suivant les souhaits des utilisateurs.
4 - Quitter : Amiga + Q
-------------------
Avec un racourci clavier maintenant consacré, cette option
vous permet de libérer environ 100 Ko de mémoire vive et de quitter DP
Managing 2.0. La fermeture de la fenètre de travail effectue une action
identique lorsqu'elle est disponible. Une boite de dialogue vous demandera
bien entendu une confirmation avant de quitter.
B - Menu Programme
--------------
Ce menu met à votre dispositions des fonctions permettant d'agir
sur un programme précis dans la base de données. Actuellement, il ne
dispose que d'une seule option.
1 - Rechercher : Amiga + J
----------------------
Cette option vous permet de recherche un programme dans toute
la base de données. Pour cela, un requester va s'ouvir où vous pourrez
inscrire le nom du programme à chercher, sa catégorie et son disque si
vous les connaissez. DP Managing va alors faire une recherche et vous
indiquera la catégorie et le disque du programme s'il a été trouvé. Dans
le cas contraire, il vous signalera que le programme n'a pas été
trouvé.
C - Menu Exporter
-------------
Ce menu met à votre disposition des fonctions pour exporter
toute la base de données ou une partie vers un nouveau format de fichier
destiné au serveur d'Ordileers. Si vous êtes une association, ce type
de service à la carte peut aussi être réalisé à faible coût, suivant la
complexité du format. Pour plus de renseignements me contacter ou contacter
Ordileers au 9 Bis, rue du Général de Gaulle, 59115 Leers (Tél : 20.82.95.36
: serveur minitel en semaine et interlocuteur le week-end) pour le serveur
et le déroulement des échange de données.
1 - Nouveautes : Amiga + D
----------------------
Cette option vous permet de n'exporter que les nouveautés
de la base de données vers le format de fichier du serveur Ordileers.
2 - Tout : Amiga + T
----------------
Cette option vous permet d'exporter toute la base de
données vers le format de fichier du serveur Ordileers.
3 - Correspondance Code-catégorie : Amiga + R
-----------------------------------------
Dans le format de sortie, chaque catégorie est représentée
par un code de 2 caratères. Cette option permet de générer un fichier texte
montrant clairement à quelle catégorie correspond chaque code.
D - Menu Imprimer
-------------
Ce menu regroupe toutes les fonctions d'impression.
1- Nouveautés : Amiga + N
----------------------
Cette option vous permet de n'imprimer que les nouveautés
de la base de données. Avant l'impression de chaque catégorie il vous sera
demandé de confirmer. Si vous cliquer sur [CANCEL] DP Managing 2.21 passera à
la catégorie suivante, et n'imprimera pas l'entête de la catégorie refusée.
Cette demande de confirmation vous permettra ainsi de préparer vous-même
votre page.
2 - Tout : Amiga + U
----------------
Cette option est similaire à la précédente, sauf que tous
les programmes seront imprimés et pas seulement les nouveautés.
Personnellement je vous conseille de changer de page avant l'impression
de chaque catégorie. Ceci vous permettra de mettre facilement à jour votre
catalogue en imprimant d'abord les nouveautés. Vous pourrez ainsi noter les
catégories qui comportent des nouveautés et n'imprimer que celles-ci. Il
suffira alors de ne changer qu'une seule page dans votre catalogue et non
toutes les pages car la mise en page des autres pages ne sera pas altérée.
3 - Statistiques : Amiga + I
------------------------
Cette option vous permet d'imprimer un bilan des statis-
-tiques des emprunts de programmes. Actuellement seul le nombre d'emprunts
par catégorie est imprimé mais suivant les besoins des utilisateurs, cette
possibilité pourra être étendue sans problème. En effet, je ne connais pas
suffisament les besoins des utilisateurs en matière de statistiques.
4 - Correspondance code-catégorie : Amiga + G
-----------------------------------------
Cette option vous permet d'imprimer clairement sur papier
à quelle catégorie correspond chaque code du serveur d'Ordileers.
5 - Quelques catégories : Amiga + K
-------------------------------
Cette nouvelle option apparue avec la version 2.1 vous
permet de n'imprimer que quelques catégories. Une ListView va apparaitre à
l'écran. Vous pourrez alors sélectionner une catégorie à imprimer. Pour
procéder à l'impression, cliquez sur OK. Ce processus va recommencer jusqu'à
ce que vous cliquier sur [CANCEL].
E - Menu Modules
------------
1 - Consultation Simple : Amiga + O
--------------------------------
Cette Option vous permet d'accéder au module de consulta-
-tion de la base de données. Ce module est le module par défaut lorsque vous
démarrez DP Managing 2.21. A titre d'information, un programme du type
catalogue sera basé sur ce module. Le produit permettra d'expédier le cata-
-logue sur disquette dans une forme plus agréable que le simple fichier
texte à lire intégralement. Ce produit ne sera lancé qu'en 1993 car le
parc d'Amigas sous OS 2.0 est actuellement trop restreint.
2 - Emprunts : Amiga + E
--------------------
Cette option vous permet d'accéder au module de traitement
des commandes de programmes. Vous n'aurez qu'à rentrer les commandes à la
souris et le module vous demandera au fur et à mesure les disquettes et met-
-tra à jour les statistiques.
3 - Ajout de programmes : Amiga + P
-------------------------------
Cette option vous permet d'accéder au module permettant de
compléter la bibliothèque de programmes et de remplir la base de données.
Dans ce module, seul l'ajout de progammes sous la forme de fichiers
individuels n'est possible. Pour les disquettes complètes il faut aller dans
le module de maintenance. Il est de plus indispensable que le programme ne
fasse qu'un seul fichier. Pour cela, je vous conseil de compacter vos pro-
-grammes et vos répertoires à l'aide de lha. L'extension .lzh est aussi
conseillée, mais pas indispensable pour vos noms de fichiers.
RAPPEL POUR LHA :
---------------
Pour compresser un fichier unique avec lha taper :
lha -2 a <nom de fichier>.lzh <nom de fichier>
Pour compresser un répertoire complet, taper :
lha -r -2 a <nom de fichier>.lzh <répertoire>/#?
Enfin, il est conseillé de compresser également les icônes
4 - Statistiques : Amiga + S
------------------------
Cette option vous permet d'accéder au module de statisti-
-ques sur les emprunts dans la base de données. Aucune mise à jour n'est
nécessaire, le module d'emprunt s'en chargeant pour chaque nouvelle com-
-mande.
F - Menu Langues
------------
Ce menu vous permet de chisir la langue de DP Managing.
actuellement vous avez le choix entre anglais et français.
1 - Francais : Amiga + F
--------------------
Cette option met DP managing en français.
2 - English : Amiga + H
-------------------
Cette Option met DP Managing en anglais.
IV - Description des divers modules
------------------------------
A - Maintenance
-----------
La première chose qui frappe aux yeux est bien sûr 2 grandes
listes comportant pour la première la liste des catégories disponibles et la
liste des programmes de la catégorie sélectionnée. Tout le module va s'orga-
-niser autour de ces 2 Gadgets qui sont issus de la GadTools.library.
En dessous de chaque liste on peut voir 1 Gadget de texte permettant de
visualiser l'élément sélectionné. Si vous cliquez par inadvertance dedans
vous pourrez rentrer du texte, mais ceci sera sans effet et l'ancien contenu
sera rétabli en tapant [RETURN].
Nous allons maintenant décrire chacune des fonctions de ce module acces-
-sible par les différents boutons.
1 - DETRUIRE LA CATEGORIE
---------------------
Ce bouton permet de détruire la catégorie sélectionnée dans
la liste. Attention, tous les programmes associés à cette catégorie seront
également éliminés de la base de données. Bien sûr, avant d'agir,
DP Managing 2.21 vous demandera de confirmer.
2 - CREER UNE CATEGORIE
-------------------
Ce bouton vous permet simplement de créer une nouvelle
catégorie de programmes. Le nom de la catégorie et son code pour le serveur
d'Ordileers vous seront demandés.
3 - ELIMINER UN ADHERENT
--------------------
Ce bouton vous permet d'éliminer un adhérent. Une liste
des adhérents existant va apparaitre à l'écran et vous pourrez sélectionner
l'adhérent à détruire. Bien sûr, vous pourrez abandonner en cliquant sur
[CANCEL] ou en refusant la confirmation qui suivra. Attention, la destruction
de l'adhérent ne supprime en aucun cas le décompte de ses emprunts dans la
base de données. Seul la liste détaillée de ses emprunts ne sera plus
accessible.
4 - AJOUTER UN ADHERENT
-------------------
Ce bouton va vous permettre de créer un nouvel adhérent.
Son nom, son prénom et sa date de naissance vous seront demandés. La date de
naissance devra être de la forme : jj-mm-aa
Bien entendu, il vous sera toujours possible d'abandonner en cours de
route cet ajout.
5 - DETRUIRE LA NOTION DE NOUVEAUTE
-------------------------------
Ce bouton va vous permettre aux nouveaux programmes de la
base de données de devenir "ancien". Ceci devra être utilisé par exemple
lorsque vous souhaitez rentrer de nouveaux programmes qui devront être les
seules nouveautés de la base de données.
6 - CHANGER DE CATEGORIE
--------------------
Ce bouton vous permet de déplacer le programme sélectionnné
vers une autre catégorie. Il vous sera alors de sélectionner une autre caté-
-gorie puis de confirmer ce changement de catégorie. Bien sûr, vous pourrez
abandonner ceci à tout instant.
7 - DETRUIRE LE PROGRAMME
---------------------
Ce bouton vous permet d'éliminer complètement le programme
sélectionné de la base de données. Attention, le nombre d'emprunts de ce
programme sera également retiré du nombre d'emprunts dans la catégorie
mais ne sera pas retiré de la liste des programmes déjà empruntés d'un
adhérent l'ayant emprunté.
8 - AJOUTER UN PROGRAMME
--------------------
Attention, cette option ne fait pas double emploi avec le
module d'Ajout de programmes. Ce bouton va vous permettre d'ajouter des
programmes à la base de données qui se présentent sous la forme d'une
disquette complète. S'il y a 2 disquettes, il faut faire 2 ajouts. Lors de
cette opération, le nom du programme, la configuration nécessaire, le com-
-mentaire et le fait que cela soit interdit aux mineurs vous seront demandés.
En cas de non abandon, une disquette formattée vous sera demandée.
Attention : n'insérer la disquette de votre programme que si vous êtes sûr
qu'elle pourra être renommée sans détruire le programme et qu'elle n'est
pas NDOS. Sinon, insérer une disquette vierge quelconque. En fin de traite-
-ment, DP Managing 2.21 vous donnera le numéro de disquette de votre nouveau
programme. Inscrivez le alors sur la disquette de votre programme, même si
ce numéro n'est pas sur la disquette.
9 - DETRUIRE UN DISQUE
------------------
Ce bouton est similaire à la destruction d'une catégorie.
DP Managing 2.21 va vous demander de choisir un disque dans une liste et va
ensuite, après confirmation, effacer la disquette et tous les programmes qui
y appartiennent. ceci peut être utile lorsqu'une disquette a été détruite.
10 - MODIFIER LE PROGRAMME
---------------------
Ce bouton vous permet de modifier la configuration et le commentaire
du programme sélectionné. Un requester va appraitre et vous n'aurez qu'à
changer les champs que vous désirez. Les champs vides seront refusés.
11 - CHARGER DES EMPRUNTS
--------------------
Cette option permet d'inclure dans les statistiques un fichier
de mise à jour externe ayant été généré par le module d'emprunts. Un
filerequester vous demandera de choisir un fichier et la mise à jour
se fera automatiquement. Pour plus de détails, consultez le module
d'Emprunts.
B - Consultation Simple
-------------------
Ce module vous permet d'explorer simplement et de façon totale-
-ment interactive la base de données. C'est d'ailleurs à partir de cela que
que sera construit la catalogue sur disquette disponible en 1993.
Vous pouvez voir 4 listes appelé Listview. En dessous de chaque listview
on peut aussi distinguer un gadget de texte permettant de visualiser ce que
vous avez sélectionné. Il est inutile d'essayer d'en modifier le contenu,
ceci sera sans effet.
Si vous cliquer sur l'une des catégories disponibles, la liste des pro-
-grammes de la catégorie doit se remplir avec le bon contenu. Le premier ou
le second programme sera alors sélectionné et le disque auquel il appartient
le sera aussi. Vous pourrez ainsi voir la liste des programmes disponibles
sur la même disquette. Cette opération pourrait aussi se réaliser en sens
inverse en cliquant sur un disque de la liste.
Vous pouvez maintenant cliquer sur un des programmes des 2 listes de
programmes et les autres listes se mettront automatiquement à jour.
En dessous, vous pouvez alors lire les divers informations sur le pro-
-gramme : taille en octets, commentaire, configuration, nombre d'emprunts,
le fait que cela soit une nouveauté ou non, et le fait que cela soit
interdit aux mineurs ou non.
C - Emprunts
--------
Ce module vous permet de traiter les commandes des adhérents.
Attention, ce module créer 2 fichiers temporaires qu'il faut absolument
effacer avant d'entrer dans ce module s'ils existent. Leur existence avant
d'entrer dans ce module est en général dûe à un plantage ayant eut lieu dans
une cession précédente de DP Managing 2.21. Voici les 2 fichiers à effacer :
NE_PAS_TOUCHER_DOMPUB
DpManaging_TempFile
Le non effacement de ces 2 fichiers pourrait compromettre le traitement
des commandes et détruire la base de données.
De même, il est recommandé de vider le répertoire temporaire (par défaut
: tempdir) pour éviter d'encombrer le support. Ce dernier conseil n'est pas
indispensable mais évite les risques éventuels d'erreur de la part
d'AmigaDos.
Le module présente 3 listViews : une pour les disquettes, une pour la
liste des programmes du disque sélectionné et enfin une pour la liste des
adhérents. Les menus déroulants ne sont plus accessibles pour éviter un
conflit de fichier et la seule façon de sortir et de cliquer sur le bouton
[ABANDON]. Fermer la fenètre permet toujours de quitter l'application.
Pour rentrer une commande, il faut :
1 - Sélectionner un adhérent
2 - Sélectionner le disque du premier programme
3 - Sélectionner le programme
4 - Cliquer sur [CONFIRMER L'EMPRUNT]
5 - retourner à 2 jusqu'à ce que toute la commande soit saisie.
Pour effacer un programme d'une commande :
1 - Sélectionner un adhérent
2 - Sélectionner le programme à supprimer
3 - Cliquer sur [SUPPRIMER]
Vous pouvez ainsi vous balader dans toutes les commandes des adhérents
simplement en cliquant sur son nom. Si vous cliquer sur un des programmes
déjà emprunté d'un adhérent, vous pouvez aussi obtenir sa taille en bas de
l'écran. Le nombre de disquettes nécessaires est aussi indiqué. Enfin, il
faut savoir que, par défaut, une commande fait une disquette.
Lorsque toute les commandes on été saisies, il vous faut choisir le
mode de mise à jour des statistiques des emprunts. Pour cela, vous
avez à l'écran 2 boutons vous permettant de mettre les statistiques à jour
sur un fichier externe soit directement dans la base de données. Si, vous
ne travaillez qu'avec un seul Amiga vous n'aurez qu'à choisir une mise
à jour directe. Toutefois, si vos commandes sont traitées sur plusieurs
micros, 1 seul devra faire une mise à jour direct, et c'est celui qui
doit gérer tout votre base de données en générales : les autres ne sont
que des sous-traitants. En effet, pour les autres, il faut choisir une mise
à jour externe : un fichier sera alors généré et son nom vous sera communiqué
en fin de traitement. C'est ce fichier qui contiendra la mise à jour
des statistiques et qui devra être chargé par le micro principal dans le
module maintenance. A ce moment là, les statistiques seront vraiment à
jour sur le micro principal.
Lorsque vous avez choisi votre mode de mise à jour,il vous suffit
de cliquer sur le grand bouton [TRAITER LES EMPRUNTS]. DP Managing 2.21 vous
demandera alors successivement les disquettes de la bibliothèque comportant
des programmes commandés et les mettra dans le répertoire temporaire.
Ensuite, il vous demandera les disquettes des adhérents pour traiter
les commandes individuelles. Pendant ce processus, les Gadgets ne sont
en aucun cas accessibles. En fin de traitement, DP Managing 2.21 retourne
au module de consultation.
Si vous avez cliqué sur [ABANDON] avant de commencer le traitement, vous
retournerez au module de consultation également.
D - Ajout de programmes
-------------------
Ce module va vous permettre de compléter la bibliothèque et de
remplir la base de données de façon transparente. Pour cela, chaque program-
-me doit se trouver sous la forme d'un seul fichier. Pour cela, je vous
recommande de compacter vos programmes dans 1 seul fichier. L'extension .LZH
est conseillé pour vos fichiers compactés et l'utilitaire recommandé est
lha (cf ligne 477). Tous vos fichiers compactés doivent être dans un même
répertoire.
Lorsque vous lancez ce module, un FileRequester s'ouvre et vous demande
de choisir le répertoire où se trouvent vos fichiers programmes. Ce
Requester ne vous montrera que les fichiers munis de l'extension .LZH.
ATTENTION : Aucun autre fichier que les programmes à inclure dans la
--------- base ne devra être présent, sinon il sera considéré comme
un programme à ajouter (l'abandon est possible mais
déconseillé).
Les fichiers présents dans ce répertoire vont être
effacés au fur et à mesure qu'il seront ajouté dans la
bibliothèque : vérifier si vous voulez les effacer du
disque.
Pour travailler dans de bonnes conditions, veillez à préparer une
quantité suffisante de disquettes vierges formattées pour copier les pro-
-grammes sur disquette : DP Managing 2.21 vous les demandera lorsqu'il en
aura besoin et vous donnera leur numéro à inscrire sur l'étiquette.
Chaque disquette portera comme nom son numéro. Veillez à ne jamais les
renommer.
Une fois le répertoire choisit, DP Managing 2.21 va passer en revue tous
les programmes du répertoire et vous demandera divers informations pour
chacun d'eux : Tout d'abord, il va falloir choisir la catégorie du program-
-me. La liste des catégorie va apparaitre dans une fenètre avec le titre
du programme dans la barre des menus de l'écran. Vous pourrez alors choisir
une catégorie ou abandonner par [CANCEL].
Ensuite, divers Gadgets de texte et de boites à cocher vont devoir être
remplis concernant le commentaire, la configuration et le fait que le pro-
-gramme soit interdit aux mineurs ou non.
Il vous suffira alors de confirmer l'ajout pour que celui-ci soit ef-
-fectif. Vous pourrez aussi abandonner cet ajout pour passer au suivant ou
tout abandonner.
Si vous confirmer l'ajout, DP Managing 2.21 va vous demander soit une
disquette vierge pour le rajouter à la base, soit une disquette déjà
existante pour y copier le programme et va alors effacer ce programme du
répertoire d'origine.
Cette procédure va se répéter jusqu'à ce qu'il n'y ait plus de
programme dans le répertoire et le programme va retourner au module de
consultation.
E - Statistiques
------------
Ce module vous permet d'avoir des informations sur les
statistiques des emprunts de programmes dans la base de données.
Dès le premier regard, on peut distinguer 2 parties dans la nouvelle
fenètre :
A gauche, 1 colonne comporte 2 listview contenant la liste des
catégories et la liste des programmes de la catégorie sélectionnée.
On peut voir en dessous de chacune d'elles le nombre d'emprunts
de chaque catégorie et de chaque programmes.
A droite, les gadgets concernent les adhérents pris individuel-
-lement. On peut voir la liste des adhérents et à coté la liste
des programmes que l'adhérents sélectionné a déjà empruntés. On
peut bien sûr sélectionner un programme, mais ceci est actuel-
-lement sans effet, mais pourra être compléter dans une version
ultérieure. En dessous, on peut obtenir diverses informations sur
l'adhérent : prénom, age, nombre de commandes
de 5 programmes et nombre de programmes empruntés, ce qui permet
de faire un calcul sur la taille moyenne en programmes d'une com-
-mande.
Conclusion
----------
Voilà, je pense avoir fait le tour des principales possibilités de
DP Managing 2.21. Comme vous pouvez le constater, DP Managing est un produit
qui a bien évolué depuis la version 1.2 écrite en GFA Basic 3.01 et qui
évoluera encore beaucoup. Mais attention, cette évolution dépend de vous,
utilisateurs, auxquels je suis toujours ouvert pour des critiques
constructives et des plaintes ouvertes.
----------------------------------------------------------------------------
----------------------------------------------------------------------------
Historique des Versions :
Version 1.23 : 20 Aout 1991
Première version opérationnelle de DP Managing qui ne
portait pas encore ce nom. Ecrite en GFA Basic 3.01, elle
travaillait uniquement en mémoire avec des fichiers textes.
La base de donnée était limitée à 1500 programmes et à 30
catégories avec en plus, seulement 50 programmes par
catégorie. L'application nécessitait 2 Mo de mémoire de
libre pour fonctionner et devait supporter les nombreux
Bugs du GFA Basic 3.01.
Version 2.0 (Révision 4.52) : 11 Aout 1992
Seconde version disponible au public. Entièremement
réécrite en SAS/C 5.10b et repensée pour l'OS 2.04, DP
Managing représente 8913 lignes de code final, plus de
10000 de code intermédiaire de développement et 350 heures
de travail. Je remercie au passage Franck Gédo pour son
aide dans le débugging, ses conseils dans le design et la
correction du présent texte.
DP Managing 2.0 n'est maintenant limité que par les
capacités disques en ce qui concerne la taille de la base
de données. Un minimum de traitement se fait en mémoire et
DP Managing 2.0 traite maintenant les commandes des adhé-
-rents dans leur intégralité (copie et statistiques) ainsi
que la mise à jour complète de la bibliothèque de program-
-mes.
Version 2.1 (Révision 5.01) : 17 Aout 1992
Troisième version, non diffusée au public,n'est plus
existante actuellement.
- Bug concernant le calcule de l'age des personnes fixé
(l'age était majoré de 1 an).
- Bug concernant l'effacement d'un disque : le disque
était effectivement effacé sur disque, mais pas en mémoire
vive.
- Modification du texte de l'option "A Propos..."
- Comme prévu, on peut maintenant n'imprimer que quelques
catégories (dernière option du menu imprimer).
- Organisation du code revue pour une plus grande
modularité : le code est le même pour toutes les versions
- Correction du Bug concernant l'impression des entêtes
de catégories où il n'y avait rien à imprimer.
- Agrandissement des champs de vision du module de
consultation.
- Correction de quelques erreurs dans la documentation
- Les versions d'évaluation est complètes sont mainte-
-nant présentent dans le même code.
- Tous les Requester supportent les raccourcis clavier
avec touche [RETURN] pour OK et [ESC] pour CANCEL
- Le pointeur d'attente est maintenant animé et apparait
à des moments plus opportuns.
- La plupart des Gadgets acceptent un raccourci clavier
signalé par un soulignement de la lettre mise en cause.
- Le décompte du nombre de disques nécessaires dans une
commande est plus réaliste.
Version 2.11, Révision 5.21 : 21 Aout 1992
Quatrième version de DP Managing et troisième disponible au
public. Cette version est nettement plus stable que
la version 2.1 et comporte des améliorations permettant
d'utiliser DP Managing tant au clavier qu'à la souris :
- Tous les requester apparaissent maintenant dans l'écran de
DP Managing et non plus dans le Workbench : La reqtools a été
abandonnée dans de nombreux cas du fait de son comportement
trop aléatoire.
- Les saisies d'adhérent, de catégorie et de programme supporte
maintenant les raccourcis clavier en entier
- Lorsqu'on veut détruire un disque ou un adhérent, il ne nous
est plus demandé de choisir une catégorie parmi les disques ou
adhérents proposés.
- Les champs de saisie lors de l'ajout d'un programme ont été
agrandis.
- Le pointeur animé a été abandonné, du fait du manque de clarté
à ce sujet dans la reqtools.library.
- La plupart des gagdets de saisie de texte supportent maintenant
les raccourcis clavier
- Lors de la sélection d'un adhérent ou d'un disque à effacer,
un requester d'information apparait lorsque l'on n'a rien
sélectionné.
- Un résidu de code de débuggage de la version 2.1 a été supprimé.
Révision 5.22 : 22 Aout 1992 : quatrième version disponible
au public. La révision n'ayant été diffusée qu'à très petite
échelle, cette révision remplace la précédente qui ne sera plus
disponible.
Maintenant, le module d'emprunts supporte à son tour les
raccourcis clavier et le titre d'écran a été corrigé pour être
en harmonie avec les autres.
Révision 5.23 : 28 Aout 1992 : Cinquième version disponible
au public. Cette version remplace la précédente.
Quelques Bugs ont été corrigés et maintenant DP Managing donne
l'unité utilisée pour indiquer la mémoire libre au lancement.
Révision 5.30 : 29 Aout 1992 : Sixième version disponible au
public. Cette version remplace la précédente :
Maintenant les requesters apparaissant lors de l'ajout de
programmes n'apparaissent que lorsqu'ils sont nécessaires : il
n'y en a plus 2 pour nous informer que les diverses phases se
sont bien réalisées : ils ne sont là que lorsqu'il y a des
problèmes ou dans le cas contraire, acceptent les raccourcis
clavier.
Révision 5.31 : 5 Septembre 1992 : Septième version
disponible au public. Cette version remplace la précédente :
La routine de sauvegarde du catalogue avait été réécrite
pour la version 2.1 et elle sauvegardait aussi la configuration,
ce qui rendait le fichier illisible avec MuchMore.Ce Bug est fixé
La date de réalisation apparait maintenant dans l'option
"A propos...".
Le sommaire a été corrigé (numéros de ligne faux)
Version 2.2 : Révision 6.2 : 12 Septembre 1992
Nouvelle version de DP Managing finalisé pour ATACOM 92 :
- Support de 2 langues : DP Managing est binligue
- Ajout d'un nouveau toolstypes pour le support des langues
- Support les moniteurs NTSC (à tester)
- Permet de modifier le commentaire et la configuration d'un
programme
- Permet de rechercher un programme dans toute la base de données,
de façon intelligente.
- Documentation partiellement traduite en anglais
- L'effacement des programmes dans le répertoire temporaire est
maintenant effectif lorsque toute les commandes ont été traitées
- Possibilité de traiter les commandes sur plusieurs micros et
de regrouper les statistiques sur un seul par la suite.
Version 2.21 : Révision 6.5 : 15 Septembre 1992 :
Version débuggée de la révision 6.2 :
- Le changement de langue dans le module de maintenance ne conduit
plus à une méditation du gourou.
- Les fichiers de documentation sont tous traduits en anglais dans
leur intégralité.
- Les messages en anglais ne se superposent plus au autres gadgets
du module de statistiques.
Révision 6.51: 16 Septembre 1992 :
- La taille des programmes du module de consultation n'affiche
plus -1 : Bug fixé :Merci à Jérôme Torchy de me l'avoir
signalé
----------------------------------------------------------------------------
Evolutions futures probables du produit :
- Ajout d'un port ARexx
- Ajout de nombreux éléments lors de l'impression des statistiques
- fonctions de compression données style lha intégrées au programme
- fonctions de formattage et de copie de disquette complète intégrées
au programme, si Commodore daigne bien me fournir les fichiers
de développement V37 ou plus et débugge la fonction Format de la
Dos.library
- Corrections des éventuelles erreurs contenus dans la documentation
et amélioration de sa clarté dans les passages assez obscures.
(j'aimerais que l'on me les signales car pour moi, tout est clair)
- Suppression de la fenètre de lancement
----------------------------------------------------------------------------
----------------------------------------------------------------------------
Pour tout renseignement, contactez-moi à l'adresse citée au début de ce
document, ainsi que pour tout rapport de bug. Pour ce dernier problème,
veillez à le rédiger comme Commodore le prescrit :
1) Matériel utilisé
----------------
* Modèle d'Amiga
* Capacité et type de mémoire RAM (slow, Chip, Fast, autoconfig)
* Custom Chip : nom, revision (R3 pour Denise ECS 8373), réferen-
-ce, ECS ou non, PAL/NTSC
* Périphérique de sauvegarde utilisé : disque dur, disquette
avec capacité totale et espace disque libre
* Autre équipement dans le système suceptible de détourner
certaines choses interdites (cartes Freezer etc...)
* Extension Hardware style carte accélératrice
2) Environnement logiciel
----------------------
* Version des logiciels système (Kickstart et WorkBench) sous
la forme 3X.XXX et non pas 2.XX
* Numéro de version de toutes vos librairies du répertoire libs:
* Numéro de version de vos devices et handlers
* Référence de tout programme utilisé en même temps (antivirus,
accélérateur de souris, relogement de ROM en RAM 32 Bits, etc)
3) Analyse du problème
-------------------
* Description détaillée du problème
* Description détaillée des phases nécéssaires à la reproduction
du problème.
* Conséquences engendrée par ce problème (corruption de la base
de données, méditation du Gourou, etc...)
----------------------------------------------------------------------------
----------------------------------------------------------------------------
Toutes les marques citées sont des marques déposées par leur déposeur
respectifs.
Merci à : - Jay Miner pour l'Amiga
- Bell Laboratorie pour le langage C
- SAS Lattice pour son compilateur C
- Tous les ingénieurs de Commodore-Amiga pour l'OS 2.04
- Franck Gédo pour le design, la correction du présent texte et les
tests.
- Nico François pour la powerpacker.library et la reqtools.library
utilisées dans ce programme.
- Ordileers pour ses idées et conseils constructifs
- Jan van den Baard pour GadToolsBox 1.0
- Jérôme Torchy pour avoir trouvé le bug dans la révision 6.5
Les fichiers powerpacker.library et reqtools.library sont Copyright (c) Nico
François.
DP Managing 1.23, DP Managing 2.0, DP Managing 2.1, DP Managing 2.11,
DP Managing 2.2 et DP Managing 2.21 sont (c) 1991/1992 Scrève David
DP Managing 2.21 est librement distribuable, le code d'entrée me permet-
-tant simplement d'enregistrer les utilisateurs et de maintenir une certaine
sécurité parmi les utilisateurs.
DP Managing 2.21 ne pourra être utilisé avec des buts lucratifs.
Toute contribution morale ou financière à mes efforts pour donner à l'Amiga
une réputation qu'il mérite depuis longtemps seront les bienvenues.
****************************************************************************
****************************************************************************
Have a FUN with DP Managing 2.21 and don't forget :
//
***************** Only \X/Amiga Makes It Possible ***********************
****************************************************************************
****************************************************************************